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10% Distribution 
From: T. H. Van Vleck 
Late: Lecember 19, 1975 


Subject: Changes to User King Frograms for New Storege Systen 


This mémorandum descrives the necessary changes to the 
system command and subroutine library and to user programs to 
nandle the new interfaces provided by the new Multics Storege 
system. 

NEW STATUS COLES 

Several new Status codes can be returned by the storage 

the current 


system when users attempt operations present in 


Logical Volume Not Mounted 


The code error_table_gmount_not_ready indicates that thes 
Storage for -a segment resides on 2a non-permanent volume which ths 
user has not mounted. This ecde should be returned only for 
attempts to reference the data or VTOC attributes cf a segment; 
that is, it should be possible to list the ACL of a segment or to 
rename it even though its logical volume is not mounted. The 
code can be returned by initiate, truncate, delentry, and by the 
following other hes_ entries: 


set_max_length, set_max_length_seg 
reclassify, access_class_check 
Status_long, status_ 

star, star_list, list _dir 


Multics Project internal working documentation. hot to be 
reproduced or distributed cutside the Multics Froject. 


MULTICS TECHNICAL BULLETIN MIB-24% pare < 


Fhysical Volume Not Found 


tinis ecde is returned if the ohysical volume unicue IL for a 
serpment cannot be translated into a pvt index. If the logical 
volure check above has succeeded, this code indicates that the 
physical volume nas been deleted from the logical volure, perhaps 
due to damage to the volume, or that the branch is damaged, or 
that the logical volume is being cemounted. This code can be 
returnec as a subcondition of seg_fault_error. 


oegment Is Page Control Out Of Service 


tie ecde error_table_¢seg_ busted is returned es 2 
Subecndition of seg _fault_error whan an 1/0 error has ceccurre2d cn 
the segment. A new hes_ entry is provided to resst the switen 
Which causss. this error. 

Logical Volume Full 
The status code error_table_¢log_vol_full is also a 


Subcondition of s2g_fault_error. It occurs when a segment cannot 
be moved te any other pack in a logical volume, and when the pack 
tne segment is on is full. 


Physical Volume Gut of Service 


The status code error_table_¢volume_error results when a 
physical volume is determined to be out of service. this code 
can be returned as a subcondition of seg _fault_error, 


The status ecde error_table_tvtoces _connection_fail i 
returned as a subcondition of seg _ fault_error when a segment! 
branch does not match its VTOC entry. The condition mey ari 
due to unique lL or directory switch mismatch. 
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New Case for Access Isolatior Error 


error_table_tai_restricted can.be returned for a 


The code. 
néw case, if the access class of the segment or directory being 
appended does not fall within the access class bracket of thse 
logical volume where the storage will reside. 


Master Directory 


The status code error_table_$master_air will be returned 
when attempts are made to mceve quota down to or up from a master 
Girectory. This error will <lso occur for attempts to delete an 
empty master directory from tne user ring. (If the directory is 
nonempty, error_table_$fulldir will be returned.) 


WUOTA 


In the old storage. system, quota was 4a one-dimensional 
quantity. In the new system, quota on one logical volume is 
different from quota on .another, and those programs which 
manipulate quota must bs aware of the difference. Tne system 
will refuse to move quota down to or up from a master directory. 
In addition, every directory now may have two cuotas, one for 
cirectory pages and one for segment pages. © | 


Directory quota is handled just like regular quota. New 
tools commands will be provided as follows: . 


set_dir_quota 
move_Gir_auota 
get_dir_quota 


The administrative tools will not, initially, set a 
directory-page quota on. project directories; it will therefore 
be an installation option whether to use directory quota at all. 
A site which wishes to use directory quota will medify its 
master.ec to give a directory quota to each project directory. 


ihe administrative tools for charging for disk usage will be 
modified to record the sons_lvid for each directory with quota 
when collecting disk usage information. The sons_lvid will be 
returned in the argument which now contains “"infqent," the 
inferior quota count, which is not maintained under the new 
storage system. The program charge disk will be modilird to 
charge only for pare-seconds on system-owned volumes. the system 
tools for disk usage recordins will be modified to be usable by 
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~~ 


the owners of private volumes so that they can manage cuotae on 
their private packs as well. 


CHANUES TO STORAGE SYSTEM PRIMITIVES 


in additicn to returning new status codes in the 
circumstances described above, the storage system primitives have 
changea in several other respects. | 


Status 


The entry hes_¢status_long will return the logical volume id 
(lvid) for a segment in the field now labeled "account." In the 
current system this field is always returned Zero. For 
directories, the lvid is always the root logical volume: so 
Sstatus_long will return the sons_lvid for the directory instead. 


both hes_¢{status_ and hes_#status_long will return a sinele 
bit for directories in what is now a pad field, to indicate 
whetner a directory is a master directory or not. 


All entry points to status including é¢status_minf and 
gstatus_mins will return error_table $mount_not_ready if the 
logical volume which contains the contents of the segment has not 
been mounted by the process. When this status code is returned, 
any information which is determinable from the directory (which 
is always onlin=) will be filled in. 


ine entry status_for_backup will return physical volume ia 
as well as lvid, sons_lvic, and master_dir switch. The nurber of 
words returned by this entrypcint may increase. 


both hes _$star and hes _¢star_list will work whether or not 
the logical volume which has the storage for the sons of a 
Girectory has been mounted by the process; but 
error_table_$mount_not_ready will be returned along with whatever 
valid information is available. This situation will cecur even 
if a directory has no segments in it (and thus no informetion is 
unévailéble). 


Similar changes will be made to list_dir. 
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Application programs must not use values of the following 


items about segments when the status code gmount_not_ready is 
returned: 


date and time modified 
date and time used 
current length 

records used 


Complete information is returned about directories and links in 
all cases. | 


A néw antry point for tre use of the list command will be 
provided. it is described below in the. section on list. 


belentry and Truncate 


Tnese primitives work normally unless the logical volume 
containing the segment has not been mounted by the process. if 
the volume is not mounted, e?#rror_table_g¢mcunt_not_ready is 
returned. 


This change means that there are. some. segments which a 
process may find it cannot delete, and cannot use. 


COMMAND CHANGES 


— 
f+ 
tA 

ct 


Calls to hes.$star_list will take much more real time and 
some additional CFU time because the VTOC reads needed to obtain 
the dates and records used will, in general, requir? an arm 
motion for each entry. a 


the list command will be modified to-change the standard 
output as follows: instead of. -pecords used, list 
(bitcount/36664). Also, list date and time branch medified when 
-dtm is requested, only returning date and time segment modified 
when a new control argument, -dtem, is supplied. A new 
antrypoint to star. will be provided whien returns all the 
information which can be given without going to the VTUC. 


For those entries to star_ which do require VTCC I/t, 
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realtime wait should te improved by sorting the éntriss by 
physical volume id and VTOC index, to attempt to minirize ek 
time. 


pir info 


Ine programs save_Gir_info, comp_dir_info, and list _cdir_info 
witn segrents which contain listings of a directory's 

s. These programs must be updated to handie at least tne 
(sons_lvid for directories) and mester_dir switch. Fhvsice 
volure ic (pvid) should probably also be saved end checksc. 
These changes will necessitate a redeclaration of the dir_info 
Segment and compatibility code so that old and new formats cen be 
eccripared and listed. The lvid and pvid should be stored in 
charecter string form rather than in binary. 


wew utility Subroutine 


As pert of the volume registration package the system must 
be able to translate from a 36-bit binary lvid to a 32-character 
logical volume name, and similarly for pvid. The hardcore has no 
knowledge of the logical or _  pnysical volume neme: this 
information must be retrieved from th2 ring-1 HCP date bases. 
This pos2s a slight problem: shoulc the user be able to determine 
the name of volumes to which he doesn't have access? 


kuestion Handlers 


inet programs nd_handler_ and cl_handler_ should te rocdified 
to know that some segments cannot be deleted, and to t3ll the 


user why. 


Create Gir 


ih2 create_dir command will need to accept a new control 
argument, 


-volume LVname 


h cate argument 
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